home *** CD-ROM | disk | FTP | other *** search
/ Bible Heaven / Bible Heaven.iso / berean / berean.doc next >
Text File  |  1993-04-30  |  23KB  |  481 lines
  1.                    BEREAN
  2.                     1.0
  3.  
  4.           "And the brethren immediately sent away Paul and
  5.          Silas by night unto Berea... who... were more noble
  6.           than those in Thessalonica, in that they received
  7.           the word with all readiness of mind, and searched
  8.               the scriptures daily..."
  9.  
  10.                 Acts 17:10-11
  11.  
  12.  
  13. Introduction to BEREAN
  14.  
  15.   BEREAN is a great Bible search and concordance program that will help you
  16.   to search the Scriptures daily for yourself.  Verses that you know are
  17.   "in there somewhere" can be located in seconds with the help of BEREAN. 
  18.   And verses that you never imagined were "in there" will fill your screen
  19.   (and hopefully your heart!) as the computer searches the entire text of
  20.   the Bible - IN JUST SECONDS!!
  21.  
  22.   At this point in time (February of '89) there are three versions of
  23.   BEREAN available:
  24.  
  25.  
  26.     VERSION            DISK SPACE    MEMORY REQUIRED
  27.     -------------------------------------------------------
  28.  
  29.     The 4 Gospels        330k        107k
  30.     New Testament        675k        166k
  31.     Whole Bible        2.5 meg        389k
  32.  
  33.  
  34. Why I wrote this program
  35.  
  36.   I'm the supervisor of the computer department and chief programmer at a
  37.   major christian ministry based in east Texas.  I originally started to
  38.   write BEREAN for our own use here at the ministry (we produce a magazine
  39.   and a lot of tracts, among other things).  I wanted people here to have
  40.   an easy to use Bible research tool since a lot of our time is spent
  41.   teaching the Bible and writing christian growth and discipleship
  42.   literature.  BEREAN was designed to speed up the time consuming process
  43.   of searching through concordances so that we could concentrate our time
  44.   and efforts on WHAT the Bible says instead of spending hours in the
  45.   mechanics of WHERE the Bible says it.  I wanted people to have a valuable
  46.   tool that would help them to "redeem the time because the days are evil."
  47.   (Eph. 6:5)
  48.  
  49.   BEREAN is a tool that will help you to spend more quality time in
  50.   Bible itself and less time in a technical reference book.
  51.  
  52. BEREAN IS SHAREWARE - WITH A NEW TWIST!
  53.  
  54.   BEREAN has helped so many people down here at our ministry that I want
  55.   everyone to be able to use it to speed up their study of the Bible.  I've
  56.   decided to release BEREAN as a new kind of SHAREWARE so that anyone who
  57.   wants it can take advantage of the benefits it provides.
  58.  
  59.   BEREAN took a huge investment of my time (just ask my wife) and my money
  60.   (for the programmers development software and tools, which aren't cheap!)
  61.   - and it took literally hundreds of hours to complete and debug.  The
  62.   text of the whole Bible had to be restructured in a way that a computer
  63.   could understand, and then checked thoroughly for accuracy to make sure
  64.   no misspellings, deletions, or additions had accidentally crept in (see
  65.   Rev. 22:18-19).  Then I had to write the blazingly fast code that would
  66.   search through 2.5 megabytes of text in just seconds to find every
  67.   instance of a particular word or words.  Pretty amazing stuff!
  68.  
  69.   Here's a brief explanation for those of you who don't know what SHAREWARE
  70.   is.  SHAREWARE is a great concept in software distribution which believes
  71.   in quality software at reasonable prices.  This is possible because there
  72.   is no middle man, fancy packaging schemes, or space on dealers shelves
  73.   that must get paid for through the markup cost of the package.
  74.  
  75.   The SHAREWARE revolution allows you to test and use the program for
  76.   awhile to see if it will meet your needs before you pay for it.  If you
  77.   are still using, or are ever intending to use the program after about 15
  78.   days you should pay for it.  SHAREWARE believes that if a program is
  79.   worth using, it's worth paying for. 
  80.  
  81.   You can also make as many copies of BEREAN to pass on to your friends for
  82.   evaluation or to upload onto bulletin boards AS LONG AS NO CHANGES ARE
  83.   MADE TO THE PROGRAM OR ANY OF THE FILES THAT COME WITH IT.  Pass it
  84.   around!
  85.  
  86.  
  87. IF YOU DON'T READ ANYTHING ELSE, READ THIS SECTION!
  88.  
  89.   I want people to be able to use BEREAN so much that I've come up with a
  90.   new way to make it available as SHAREWARE to anyone who wants it -
  91.   WHETHER THEY CAN AFFORD IT OR NOT.  Here's the scoop: 
  92.  
  93.   IF YOU'RE ABLE TO PAY THE PRICE
  94.  
  95.   I would ask you to send in the full suggested price as soon as possible
  96.   if you're using BEREAN or intending to use it after about 15 days.  I'll
  97.   mail you a set of disks and keep you informed of any enhancements,
  98.   revisions, or new versions as they become available.
  99.  
  100.  
  101.   IF YOU CAN'T AFFORD THE FULL DONATION
  102.  
  103.   If you can't afford the suggested donation all in one lump sum, please
  104.   send in WHATEVER you can afford WHENEVER you can afford it.  You can make
  105.   as many partial donations as you need to whenever you're able to.  I
  106.   don't have the time to keep track so you'll be on the honor system.  I'll
  107.   mail you a set of disks and keep you informed of any enhancements,
  108.   revisions, or new versions as they become available.
  109.  
  110.  
  111.   IF YOU CAN'T AFFORD ANY DONATION EVER
  112.  
  113.   If you honestly can't afford any donation but you still want to use
  114.   BEREAN please do so as a gift from me with a clear conscience.  I'm
  115.   blessed to be able to share my skills for the sake of the Kingdom of God. 
  116.   If you want a set of disks I'll mail them to you if you cover the cost of
  117.   the disks and the mailing which is about $1 per disk for 5 1/4" disks and
  118.   $2 per disk for 3 1/2" disks.
  119.  
  120.  
  121. SUGGESTED DONATION
  122.  
  123.   The 4 Gospels    (cost of disk)    comes on 1 disk
  124.   New Testament    $20    comes on 2  5 1/4" disks or 1  3 1/2" disk
  125.   Whole Bible    $50    comes on 7  5 1/4" disks or 4  3 1/2" disks
  126.  
  127.   Please send payment to:
  128.  
  129.     Kim D. Geiger
  130.     P.O. Box 1030
  131.     Lindale, TX  75771
  132.  
  133.   My daytime telephone number is (214)963-8671 if you have any questions,
  134.   suggestions, comments, or ridicule.
  135.  
  136.  
  137. Installation
  138.  
  139.   Floppy Disks
  140.  
  141.   If you have only a 360k floppy in your computer you'll be limited to the
  142.   4 Gospels version of BEREAN.  If you have a 720k, or 1.2 meg floppy
  143.   you'll be able to search the entire New Testament in one fell swoop.  In
  144.   either case you don't have to do anything to install BEREAN other than
  145.   popping it into your floppy drive and closing the drive door!
  146.  
  147.   Hard Disks
  148.  
  149.   If you are getting BEREAN on multiple disks, BEREAN will need to assemble
  150.   itself from all the bits and pieces that I've scattered across the floppy
  151.   disks.  YOU CANNOT JUST COPY ALL THE FLOPPY DISKS ONTO YOUR HARD DISK AND
  152.   EXPECT BEREAN TO RUN.  I've written an installation program to make the
  153.   process relatively painless and goof-proof.  All you need to do is change
  154.   to the directory you want the BEREAN files in, put the first disk in your
  155.   disk drive and type A:INSTALL or B:INSTALL (depending on which drive it
  156.   is).  Then, just follow the directions.  BEREAN will ask you for the name
  157.   of a drive you are copying BEREAN from and then will ask you to put in the
  158.   rest of the disks.
  159.  
  160. How To Start BEREAN
  161.  
  162.   To get up and running you just need to type the appropriate command for
  163.   the version of BEREAN you have:
  164.  
  165.   "BEREANGS" starts the 4 Gospels version
  166.   "BEREANNT" will get the New Testament version going
  167.   "BEREAN" fires up the Whole Bible version
  168.  
  169.  
  170. How To Look Something Up
  171.  
  172.   Just type in the word that you want BEREAN to search for and press ENTER. 
  173.   Your screen will be filled with the verses that contain that word.  Page
  174.   down will give you as many screens full as there are and page up will
  175.   bring you back to the beginning.  Everything will be explained in more
  176.   detail later on, but for right now you can just have fun.
  177.  
  178. How To Quit BEREAN
  179.  
  180.   Press the ALT key and the letter "E" at the same time when you're
  181.   finished exploring BEREAN.
  182.  
  183.  
  184. Using BEREAN to it's full potential
  185.  
  186.   Now lets have a look at all the features of BEREAN.  When BEREAN is
  187.   executed, it displays a blank screen.  The full screen is used for
  188.   displaying scripture except for the top line.  On the right hand side of
  189.   the top line, you will notice the current verse range BEREAN will search. 
  190.   In the upper left hand corner, the cursor awaits your every command. 
  191.   This left hand portion of the top line of the screen is for the command
  192.   line.
  193.  
  194. The Command Line
  195.  
  196.   The basic command line is looks like this:
  197.  
  198.     [book chapter:verse-book chapter:verse]+word*>filename.txt
  199.  
  200.   Don't get scared if this looks complicated.  It's really very simple. 
  201.   You can use just the simplest parts of it for a very general search or
  202.   use all the parts and get a very detailed search.  Let's have a look at
  203.   each part of the command line.
  204.  
  205. [book chapter:verse-book chapter:verse] -- Temporary Verse Range
  206.  
  207.   Whenever you ask BEREAN to search for a word for you, it searches through
  208.   a certain range of verses.  If no temporary verse range is specified in
  209.   the command line, BEREAN will use the global verse range.  The global
  210.   verse range will generally be the whole text of the scriptures you have,
  211.   but you can change the global verse range as we will see later.  You may
  212.   also change the verse range for just one search by including in the
  213.   command line a temporary verse range.  The open bracket character ([)
  214.   tells BEREAN you are entering a temporary verse range for this search. 
  215.   Directly after the '[', give the beginning verse of your range.  The dash
  216.   character (-) tell BEREAN you are about to enter the ending verse of your
  217.   range and the close bracket character (]) tells BEREAN you are done
  218.   entering the temporary verse range.  You need not enter the chapter and
  219.   verse.  If chapter and verse are not entered, BEREAN will use chapter 1,
  220.   verse 1 for the beginning verse and the last chapter and verse of the
  221.   book for the ending verse.  Lets look at some examples:
  222.  
  223.    [mal 2:2-luk 5:3]    Searches Malachi 2:2 through Luke 5:3
  224.    [mat-mat]        Searches the book of Matthew
  225.    [exo]        Searches Exodus 1:1 through to the end of the
  226.                 global verse range
  227.    [-mal]        Searches from the beginning of the global verse
  228.                 range to the end of Malachi
  229.    [mat 2-joh 5]    Searches Matthew 2:1 to the end of John 5
  230.  
  231.   Get the idea?  Good, now remember, you never really need to use the
  232.   temporary verse range.  You can leave it out and always just search the
  233.   global verse range.
  234.  
  235.   +word* -- Searching for a specific word
  236.  
  237.   This is were the fun comes in.  Type any word and BEREAN will give you
  238.   all the verses containing that word in the current verse range
  239.   (temporary, if you specified one, or else the global verse range).  The
  240.   plus sign and the asterisk are optional modifiers for the word for which
  241.   you are searching.  Either one or both can be left out.  The plus sign
  242.   tells BEREAN you want to combine this search with the previous search. 
  243.   In other words, you are telling BEREAN you want to find the verses
  244.   containing not only this word but that also contain the word(s) from the
  245.   previous search.  An example is the best illustration:
  246.  
  247.    jesus    Finds all verses containing 'jesus'
  248.    +love    combines with the previous search and finds all
  249.         verses containing both 'jesus' and 'love'
  250.    +man        Again combines with the previous search and finds all
  251.         verses containing 'jesus', 'love' and 'man'.  It, in
  252.         fact, only finds 2 verses with all three words in
  253.         them. John 14:23 and I Corinthians 16:22
  254.  
  255.   Note that if there were no verses in the previous search or there was no
  256.   previous search (you just started the program), using the plus sign will
  257.   get you no verses.
  258.  
  259.   The asterisk tells BEREAN to search for any word starting with the
  260.   letters you type just before the asterisk.  lov* will find
  261.   lovingkindness, loveth, lover, loving, love, etc.  The asterisk will,
  262.   however, only work at the end.  Now lets see some examples of the two
  263.   together:
  264.  
  265.    jesus    Finds all verses containing 'jesus'
  266.    +lov*    combines with the previous search and finds all
  267.         verses with both 'jesus' and any word beginning with
  268.         'lov'
  269.    +world    again combines with the previous search and finds all
  270.         verses with 'jesus', any word beginning with 'lov'
  271.         and 'world'.  John 13:1 is the only verse
  272.  
  273. >filename.txt -- Text file output
  274.  
  275.   This command line option allows you to output your search to a text file
  276.   so you can call it up in your word processor, print it, or anything else
  277.   you like.  If the file exists on disk, BEREAN will give you an error
  278.   message.  It will only output to a filename that does not already exist. 
  279.   If you include the redirection symbol (>) in the command line without a
  280.   filename, BEREAN will output the search to user defined global output
  281.   file (we'll discuss this later).  This way you can output several
  282.   searches to the same file.
  283.  
  284.   Now lets put it all together and look at a few examples:
  285.  
  286.   >bible.txt    will give you the whole bible on your disk in the
  287.         file bible.txt.  Note: this will take 4.5 MB of disk
  288.         and a long time
  289.   [psa        Displays all verses starting at Psalm 1:1 and ending
  290.         with the last verse in the global verse range.
  291.   [hos 2:3    Displays all verses starting at Hosea 2:3
  292.   [mat-mat] heal*    searches the book of matthew for any word starting
  293.             with 'heal' (health, healing, healeth, healed, etc)
  294.   [gen-mal]go    searches Old Testament for verses containing the word
  295.         'go'
  296.   +world    combines with previous search and finds all verses in
  297.         the Old Testament containing both 'go' and 'world'
  298.   lov*>love.txt        Outputs to file love.txt (if it doesn't already
  299.             exist) all verse with any word starting with 'lov'
  300.   hope>        If a global output file has been defined, all verses
  301.         containing the word 'hope' will go to that file. 
  302.         Otherwise, you will get an error message.
  303.  
  304. Menu System
  305.  
  306.   A pop-up menu system gives you access to some other features of BEREAN. 
  307.   The key combination ALT-M (hold the alt key and hit 'm') will display the
  308.   main menu from which these features can be accessed.  The highlighted bar
  309.   selecting the option can be moved up and down with the up and down arrow
  310.   keys.  Any option can also be accessed immediately by pressing the first
  311.   letter of the option.  Some of the options in the main menu will display
  312.   another menu from which other options can be accessed.  Pressing the Esc
  313.   key will take you back to the previous menu and exit you out of the main
  314.   menu.  You will notice that each option also has a alt-key combination
  315.   listed with it.  This is a quick way to use the feature without going
  316.   through the main menu.  Now, lets look at each of the options.
  317.  
  318. Display Options
  319.   Selecting this option will display another menu from which you may select
  320.   one of three methods of displaying the scripture.  A check mark indicates
  321.   which method is currently selected.  Full Text, obviously, displays the
  322.   full text of the scripture on the screen.  Brief Text displays a
  323.   concordance view of each verse.  A concordance view is one line of the
  324.   verse with the searched for word somewhere near the middle of the line. 
  325.   References displays a full screen of references.
  326.  
  327. Colors
  328.   Selecting the colors options displays another menu reflecting the current
  329.   display colors.  Obviously, you can only use colors on a color monitor,
  330.   but if you do have a color monitor, you have a wide selection of colors
  331.   to choose from.  BEREAN allows you to select the background and
  332.   foreground colors, a separate color for the word for which you have
  333.   searched, and a color for the scripture reference.  You can move up and
  334.   down between background, foreground, word, and reference with the up and
  335.   down arrow keys and you can change the colors for each one with the left
  336.   and right arrow keys (space bar will also work).  When you exit the menu
  337.   system, your new colors will be displayed.  BEREAN initially comes up
  338.   with the correct colors for a monochrome screen.
  339.  
  340. Verse Range
  341.   We have previously talked about the global verse range.  This is where
  342.   the global verse range can be set.  If you have a lot of searches you
  343.   need to do in just a portion of the bible (the minor prophets for
  344.   instance), you could set the global range to include only those books or
  345.   verses.  This would save you the time of having to enter the range each
  346.   time you searched for a word.  Entering the global range is the same as
  347.   entering a temporary one.  You don't need to enter the chapter and verse
  348.   and if you just hit enter for the beginning or ending verse, BEREAN will
  349.   use the old global verse range.
  350.  
  351. Save Configuration
  352.   To make BEREAN even easier to use, I have made it possible to save some
  353.   of the parameters you set up so you don't have to enter them every time
  354.   you execute BEREAN.  When selecting the Save Configuration option, BEREAN
  355.   creates a file named BEREAN.CFG in the current directory.  This file will
  356.   then be used by BEREAN to set the following parameters:
  357.  
  358.     Colors
  359.     Global Range
  360.     Display Method
  361.     RAM/BIOS Flag (whether BEREAN writes to the screen using RAM or
  362.       BIOS, see appendix for more info)
  363.  
  364.   The file BEREAN.CFG will not be there until you select this option.  If
  365.   BEREAN.CFG is not there, BEREAN will use its own preset parameters --
  366.   full bible, full text display, and monochrome monitor colors.  Also, if
  367.   the file BEREAN.CFG get corrupted, it could cause BEREAN to do some
  368.   strange things.  If, when you execute BEREAN, the colors or the global
  369.   verse range are weird, try deleting the configuration file and starting
  370.   over again.
  371.  
  372. Last Configuration
  373.   This option, very simply, restores BEREAN back to the last saved
  374.   configuration.
  375.  
  376. Text Filename
  377.   This is where you can define the global output text file.  Here, again,
  378.   the file must not already exist on your disk.  Scriptures can be output
  379.   to this global file in two ways.  The first way, discussed previously, is
  380.   to use the redirection symbol (>) on the command line with no filename. 
  381.   The second way is we will discuss in the next section.
  382.  
  383. Help
  384.   This option will give you a few selected screens full of helpful
  385.   information for using BEREAN.
  386.  
  387. Exit
  388.   This will, of course, exit you from BEREAN.
  389.  
  390.  
  391. Individual Verse Context Mode
  392.  
  393.   One last helpful feature of BEREAN involves individual verses and their
  394.   context in scripture.  Many times we will find several verses with the
  395.   word for which we are searching, but we are not sure which one is the
  396.   best verse.  Context of the verse can usually help decide which one. 
  397.   BEREAN can help you!  Once a search is completed and all the verses are
  398.   on the screen, pressing the down arrow key will take your cursor through
  399.   the verses on the screen.  Your cursor will be positioned at the
  400.   beginning of the verse here you have two features you can access:
  401.  
  402.   Verse Context
  403.     Pressing the enter key or 'c' will show you the context the this
  404.     verse in scripture.  BEREAN will show you three verses before and as
  405.     many verses after as can fill the screen.  Enter or Escape will exit
  406.     the context screen.
  407.  
  408.   Output Individual Verses
  409.     Pressing the letter 'O' (as in output) will output this individual
  410.     verse to the global text file (assuming you defined one, if you
  411.     didn't, expect an error message).  This is the second way to output
  412.     to the global text file alluded to earlier.
  413.  
  414.   Pressing escape or pressing up arrow repeatedly will bring you again to
  415.   the command line for more searching fun.
  416.  
  417.  
  418. Appendix
  419.  
  420. Book Abbreviations
  421.  
  422. GEN -- Genesis        ISA -- Isaiah        ROM -- Romans
  423. EXO -- Exodus        JER -- Jeremiah        1CO -- I Corinthians
  424. LEV -- Leviticus    LAM -- Lamentations    2CO -- II Corinthians
  425. NUM -- Numbers        EZE -- Ezekiel        GAL -- Galatians
  426. DEU -- Deuteronomy    DAN -- Daniel        EPH -- Ephesians
  427. JOS -- Joshua        HOS -- Hosea        PHI -- Philippians
  428. JDG -- Judges        JOE -- Joel        COL -- Colossians
  429. RTH -- Ruth        AMO -- Amos        1TH -- I Thessalonians
  430. 1SA -- I Samuel        OBA -- Obadiah        2TH -- II Thessalonians
  431. 2SA -- II Samuel    JON -- Jonah        1TI -- I Timothy
  432. 1KI -- I Kings        MIC -- Micah        2TI -- II Timothy
  433. 2KI -- II Kings        NAH -- Nahum        TIT -- Titus
  434. 1CH -- I Chronicles    HAB -- Habakkuk        PHM -- Philemon
  435. 2CH -- II Chronicles    ZEP -- Zephaniah    HEB -- Hebrews
  436. EZR -- Ezra        HAG -- Haggai        JAM -- James
  437. NEH -- Nehemiah        ZEC -- Zechariah    1PE -- I Peter
  438. EST -- Esther        MAL -- Malachi        2PE -- II Peter
  439. JOB -- Job        MAT -- Matthew        1JO -- I John
  440. PSA -- Psalms        MAR -- Mark        2JO -- II John
  441. PRO -- Proverbs        LUK -- Luke        3JO -- III John
  442. ECC -- Ecclesiastes    JOH -- John        JUD -- Jude
  443. SON -- Song of Solomon    ACT -- Acts        REV -- Revelations
  444.  
  445.  
  446. BEREAN Files
  447.  
  448.   Berean uses five files:
  449.  
  450.       Berean.exe (or Bereangs.exe or Bereannt.exe) -- the program 
  451.       Berean.dat (or Newtest.dat or Gospels.dat) -- the text of the
  452.         scriptures (encoded to save space)
  453.       Berean.ndx (or Newtest.ndx or Gospels.ndx) -- indexes so berean
  454.         knows where to search for each word
  455.       Berean.hlp -- contains on-line help screens
  456.       Berean.cfg -- not a necessary file, but if it is there BEREAN will
  457.         use the setup parameters stored to this file.
  458.  
  459. RAM/BIOS Flag
  460.   There are two ways to display things on the screen on IBM PC's.  The best
  461.   and fastest way is to use video RAM.  This is the way I have programmed
  462.   BEREAN to display to the screen.  However, some of the older PC clone
  463.   were not totally IBM compatible and would lock up or do weird things if
  464.   you tried to display using video RAM.  I have, therefore, made BEREAN to
  465.   be able to display through the BIOS.  This is slower but at least it
  466.   works.  If your computer does weird things when you run BEREAN, try
  467.   starting BEREAN by typing BEREAN BIOS at the DOS command line.  This will
  468.   tell BEREAN to use the BIOS to display instead of RAM.  If you will save
  469.   the configuration, you will only need to enter BEREAN, since the RAM/BIOS
  470.   flag is stored in the configuration file.  Remember, if your
  471.   configuration file gets deleted you will again need to start BEREAN by
  472.   typing BEREAN BIOS.  BEREAN will always default to RAM display unless you
  473.   specify BIOS on the DOS command line or you have saved it in the
  474.   configuration file.  Most computers sold today are totally IBM
  475.   compatible, so this will generally not be a problem.  If you have saved
  476.   the configuration file to use BIOS display and want to again use RAM
  477.   display, you can either delete the configuration file (BEREAN.CFG) or
  478.   start BEREAN by entering BEREAN RAM at the DOS command line and resaving
  479.   your configuration file.
  480. e BEREAN, the colors or the global
  481.   verse range are weird, try deletin